home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 9 / Night Owl CD-ROM (NOPV9) (Night Owl Publisher) (1993).ISO / 006a / dlist101.zip / DLIST.DOC < prev    next >
Text File  |  1993-05-09  |  5KB  |  114 lines
  1.                                DLIST v1.01
  2.                   Download File List Description Creator
  3.                             by Dave Brodmann
  4.  
  5.                      SysOp - Brodmann's Place BBS
  6.                             RIME->BRODMANN
  7.                             FIDONET 1:109/806
  8.  
  9.                   Latest version always frequable as DLIST
  10.  
  11.  
  12. 1.0 - WHAT IS DLIST?
  13.  
  14.     DLIST is a utility to help you keep track of your collection of
  15. files that you have on disk, by extracting accurate descriptions for
  16. those files.  It will read a directory of files that you specify, and
  17. either extract the description from an archive (using a file_id.diz or
  18. desc.sdi if it finds one), or extract the description from a file list
  19. that you captured while you were on a BBS.  It then creates a neatly
  20. formatted text file containing the descriptions of the files.
  21.  
  22.     It saves you the trouble of manually editing descriptions from a
  23. file list, or worse yet, not bothering with descriptions at all.  Ever
  24. wound up with a mess of zip files that you don't know what they are?  It's
  25. no fun looking through them all just to find the program you are looking
  26. for.  If you use DLIST, it will automatically create a nice standardized
  27. text file of your new downloads.
  28.  
  29.     While processing the description it also removes high and low ASCII
  30. characters (graphics, etc), cleans up spacing, and removes some of the
  31. extra trash that some BBS's tack onto the end of a description (such as
  32. "Uploaded by xxx", etc...).
  33.  
  34.  
  35. 2.0 - HOW TO USE DLIST
  36.  
  37.     DLIST needs three pieces of information from you.  This information
  38. can be provided in one of three ways:  1) as command line arguments when
  39. you run DLIST,  2) by entries in a config file dlist.cfg, or 3) as responses
  40. to questions asked by the program.  DLIST will always attempt to locate the
  41. necessary data in exactly the order I mentioned above.  First it will see
  42. if the info was provided on the command line, if not, it will check for a
  43. valid dlist.cfg configuration file, and if no config file, it will prompt
  44. the user for the data.  To use DLIST you also must have a copy of PKUNZIP.EXE
  45. either in the current directory or accessible via your DOS path.
  46.  
  47.     The information DLIST needs to run is very straightforward.  
  48.  
  49.     1) The name of the DOS directory containing the files you wish to
  50.        process.  For example:    c:\download  
  51.                              or  g:\zips\new
  52.        Note: Do not include a trailing backslash.
  53.  
  54.     2) The name of the file listing that descriptions can be extracted
  55.        from.  This most likely is a new files listing that you captured
  56.        with your communications program while you were on the BBS from
  57.        which you downloaded the files.  If no path is given DLIST will
  58.        look for this file in the current directory.  Note that this file
  59.        listing currently must be an RBBS or PCBoard type format file
  60.        listing.  See the file bbs.cap include in this archive for an
  61.        example.  Additional formats will be added in the future.  
  62.        For example:   c:\temp\bbs.cap
  63.                       file.log   (no path, meaning it is in current dir)
  64.        Hint: If you do not have a "capture log", but you want to use
  65.        dlist to extract file_id.diz and desc.sdi description files if 
  66.        they are found, simply create a "dummy" capture log.  e.g., use
  67.        DOS rem command to create a zero byte file like this: rem>bbs.cap.
  68.  
  69.     3) The name of the text file you want DLIST to output the 
  70.        descriptions to.  If no path is given this file will be created
  71.        in the current directory.  Please note DLIST will overwrite any
  72.        existing file with this name.
  73.  
  74.     As I mentioned this data can be provided to DLIST in one of 3 ways:
  75. 1) Command line, 2) Config file, or 3) let DLIST prompt you for the data.
  76.  
  77. -Command Line mode-
  78.      DLIST  <directory name>  <capture file name>  <output file name>
  79. example: DLIST  c:\download  c:\temp\bbs.cap  new
  80.  
  81. -Config file mode-
  82.     Create a file named dlist.cfg in the current directory with the
  83. parameters entered one per line, in the same order as shown above for the 
  84. the command line mode.  There should be only three lines in the file.
  85. example:
  86.  
  87. c:\download       <--Line 1
  88. c:\temp\bbs.cap   <--Line 2
  89. new               <--Line 3
  90.  
  91. -Prompt mode-
  92.     If you do not enter the command line arguments and a config file is
  93. not found, then DLIST will prompt you for each piece of data.  Once again
  94. the data will be requested in exactly the same order as above.  Answer each
  95. question and then hit <ENTER>.
  96.  
  97.  
  98. 3.0 WHAT'S NEXT?
  99.  
  100.     This is a first cut at this program, and I already have lots of ideas
  101. for improving it.  Let me know what you think, and any features you would 
  102. like to see.  I'll see what I can do.  You can reach me at my BBS, by voice,
  103. or by mail if you wish.  
  104.  
  105.  
  106.                                   Dave Brodmann
  107.                                   SysOp, Brodmann's Place BBS
  108.                                   BBS# 301-843-5732
  109.                                   Voice 301-870-9757
  110.  
  111.                                   Dave Brodmann
  112.                                   2105 Tanglewood Drive
  113.                                   Waldorf, MD 20601
  114.